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FIRSTLY, OUR CONGRATULATIONS TO THE EDITOR OF OUR 
CONTEMPORARY NEWSLETTER, JOE LEON. HE IS A GRANDFATHER. A 
GRANDSON.. 


I hope you all enjoyed our birthday issue. Now I have to 
get this issue out, and then start on our Xmas issue. Wait for 
it. It will be a special: 


I also hope to see a lot more of our members send in 
more contributions. If it was'nt for Bob Kitch and David 
Wood, this issue would be about 4 pages. 


It's your club, so let us see your name at the head of a 
column. Even if it's only a letter to say "why don't you do 
this?” | | 


One member commented that another was sweeping the High 
Scores table clean. On checking I found that they have 7 high 
scores and he had 15. Who is kidding who?. 


There are still a lot of scoring games not in that high 
list. Three have been added this issue, but there are many 
more. A score of 5 could get you in the table. Why not try it? 
Merkfruit Lodge has a scoring system, so has Chess. Also Ace of 
Aces, Armada, and many more. I don't mind filling the whole 
page with scores. 


What I would like is some small programs sent in. It 
does'nt matter how simple. I often have a half page to fill 
and. I have to write some nonsense to save having it blank. 
Some of you youngsters (70 plus) could fill that in nicely. 


Also some more comments/suggestions for the Graphics 
Competition please. 


And for local members,remember that our meetings are the 
first Sunday of each month, including the 5th of January, 1992. 
Also on the 13th October there is a buy-sell-swap on at the Box 
Hill Town Hall. We are aiming to have a stand there. If you get 
there look us up. You may use it if you have any gear you want 


to sell. No charge. ` 








ASSEMBLY LANGUAGE 


— A Coward's Introduction. 


by Bob Kitch 


Assembly Language programming can accomplish miracles, but it is made to seem almost 
as mysterious as Babylonian hieroglyphics ! Most users are fairly well versed in 
Basic programming but do not often venture into the realms of Assembly Language. 
This is a pity, as Assembler can achieve things that Basic has never dreamed of. 


One of the nice things about Basic is that you can see the results straight away. 
Type in PRINT"HELLO", press <RETURND, and the VZ displays "HELLO" on the screen. 
This is great encouragement to go on fron. Assembler, on the other hand, has always 
been presented as a massive task, requiring the mastering of strange registers, 
indirect addressing and other things that boggle the mind of a Basic programmer. If 
only you could do something simple with Assembler that would show results right 
away . 


This article is about starting off slowly with Assembler — and achieving some nice 
small things wih it. It also builds upon my FAST BASIC theme and some powerful 
applications have been presented in that hybrid language. Some of the programs 
written and presented in user group magazines include, REAL TIME CLOCK, SCREEN 
PRESERVER, LIVENUP and TONE GENERATOR. We will develop some FAST BASIC listings and 
gain some insight into Z80 Assembly Language if you want to. 


1. DOING IT FROM BASIC. 


Before we start programming, it is necessary to pose a problem! Let's do something 
in hi-res graphics (MODE(1)) because this is a little challenging. A commonly 
required problem is to initialize the hi-res screen in one of the four colours that 
it is capable of displaying. Normally from Basic, the screen comes up in the default 
colours of green or buff, depending upon the background value (B = 0 or 1) that is 
set by the COLOR,B command. Some applications look better if the hi-res screen is 
yellow/cyan, blue/magenta or red/orange when initialized. The CLS command cannot 
set-up the screen in these alternate colours. We will first of all write a program 
using standard Basic commands to achieve a blue hi-res screen. 


Listing 1 is called SNAIL GRAPHICS (for obvious reasons). Enter the program and run 
it. All of the commands should be readily understandable. If they are not, then you 
are probably not yet sufficiently experienced to proceed to the next step. 


SNAIL GRAPHICS Version 1.1 uses a double nested loop and the SET command to fill the 
hi-res screen. The colour of the screen can be altered by changing the foreground 
colour in line #130. The two SOUND commands are used so that the time taken to fill 
the screen can be measured with a stop watch. Isn't it painful! It takes almost one 
minute to do it. This is much too slow for such a simple exercise. 


Observe that the use of the SET command requires that all screen pixels, in the 
range of O to 63 amd O to 127 in the vertical’ and horizontal directions 
respectively, be SET. The colour of the pixel is determined in the COLOR command. No 
knowledge of the memory locations of the screen (video RAM), or the values to which 
the memory locations are set, to achieve the colour required by the programmer. The 
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penalty for this simple approach is time. 


Let's now investigate how we can speed-up this screen fill problem. 


2. STILL IN BASIC. 


Take a look at listing 2. To understand SNAIL GRAPHICS Version 2.3 you must have 
worked with graphics and progressed to PEEKs and POKEs into the video RAM area. 
Notice that only a single nested loop is required in this version. Also the POKE to 
the video area in line #210 actually sets four pixels rather than one. The SOUND 
commands allow timing of the screen fill and a value of around 8.3 seconds should be 
obtained. This is obviously a pretty souped up version using the Basic language. 
come other small changes to the program could get the timing down to about 8.0 
seconds - a huge improvement over Version 1.1. But we are really looking for a near 
instantaneous method, so let's progress to Assembler. 


3. THE VISIBLE Z80 


I introduce a technique here that I have not seen tried anywhere else, and that is 
to examine Z80 Assembler as if it resembled Basic. This should make the 
understanding of Assembler appear as a simpler amd more familiar step for 
programmers. The method was introduced in my program called LOGIC OPERATIONS that 
has been previously published. In that program Boolean Logic Operators and the Flag 
Register of the Z80 were simulated. In the next listing I use Basic to simulate the 
powerful Z80 Block Move instruction. 


Before introducing the third listing, I need to diverge to discussing Assembly 
Language. In all texts and articles introducing Z80 Assembler, the Block Move is 
introduced as one of the simpler opcodes to comprehend. I agree with this, and it is 
why I chose to use a screen fill as the programming example in this introduction. I 
will endeavour to explain the Block Move instruction in plain English so that it can 
be comprehended. (The Block Move instruction has been described in my hi- and lo 
res screen preserver article.) 


The 280 Block Move takes a number of forms but the one we will use has the mnemonic 
LDIR. What does this gobbly-gook mean? Firstly, LD means LoaD; this implies a 
transfer of a VALUE from a SOURCE location to a DESTINATION location. secondly, the 
I means Increment or Increase by one; implying that a progressive transfer, or 
filling, of the DESTINATION with the VALUE is to occur. And finally, the R means 
Repeat for a certain number of times, or COUNT. Does this look as though it is 
useful to solving our screen fill problem? Let's think a little further. (If you 
reflect upon Listings 1 and 2, you will see that these four parameters are also 
required by Basic.) | 


We certainly need to fill a well-defined area of memory. The video RAM for the 
hi-res screen is 800H (2048D) bytes long. This suggests COUNT or SIZE. The video RAM 
commences at address 7000H (28672D) and ends at 77FFH (30719D). Note that this is 
800H or 2048D bytes long. (You may need to think about that one!) The starting 
address of the screen suggests a DESTINATION for the commencement of the Block Fill. 
The actual VALUE to be placed in video RAM is to be supplied by the user as this 
determines the colour of the screen - recall] listing 2. The actual location of the 
VALUE can be regarded as the SOURCE for the Block Fill. By Repeatedly LoaDing the 
SOURCE VALUE to the DESTINATION for a certain COUNT. ard Incrementing the 
DESTINATION, we should be able to fill the video RAM with a particular VALUE. O.K., 
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so the LDIR opcode appears as if it will do the job for us. 


With that bit of background, you can now examine listing 3. This is a Basic program 
written for the "VISIBLE 280". The Basic program simulates what an Assembler program 
could look like that does a screen fill. The use of variable names are especially 
chosen to correspond with the "mysterious" register names on the Z80. 


By way of further background, the Zilog (the manufacturers of the Z80) specification 
for the LDIR instruction is as follows - 

a. the HL register points to the SOURCE of the LoaD. 

b. the DE register points to the DESTINATION of the LoaD. 

c. the BC register contains the COUNT or number of times the LoaD is to take place. 
d. the A register is the transfer point between the SOURCE (HL) to DESTINATION (DE) 
locations. 

e. after each transfer, the HL and DE registers are Incremented and the BC (COUNTER 
) register is decremented. 

f. the progressive LoaDing is Repeated until the BC > register is decremented to zero 
— in which case the instruction is terminated. 


Conditions a. to c. are the initialization for the LDIR instruction. The actual 
execution of the instruction involves conditions d. to f. The way in which Zilog 
express all of this is a little cryptic but for those of you interested it is as 
follows — 

(DE)<—(HL), DEX-—DE+1, HL<-HL+1, BC<~-BC-1, REPEAT until BC=0. 

I trust that you can figure some correspondence between this concise description and 
my ‘word picture" provided above. 


In lines 200 to 460, the Basic program with the corresponding psuedo-assembler is 
given. Try to follow the relationship between the two languages. Reading and 
understanding other programmers' code is a very useful form of learning. I mentioned 
that the Assembler LDIR instruction is quite powerful, it takes 4 Basic commands to 
execute it! This is unusual, as normally one Assembler instruction will translate to 
one Basic command. A full discussion of the Assembler routine is given in the next 
section. 


The algorithm used in this example is simple to understand using the characteristics 
of the LDIR instruction. There are many other routines that would achieve the same 
job. It 1s important to realize that there is never merely one way to achieve a 
particular end. The programmer generally calls upon his experience with familiar 
commands, and these may be the quickest and shortest way of achieving the object. 
But there 1s never only one correct solution to coding a particular problem. Another 
algorithm that will achieve a screen fill is as follows- 


LD HL,7000H 

LD BC, 800H 
LP LD (HL),170D 

INC HL 

DEC BC 

LD AC 

OR B 

JR NZ, LP 

RET 


So, with this background, listing 3 should be readily comprehensible. The timing is 
none to startling, but it is a demo program! 












© 4. THE SAME THING IN ASSEMBLER. 


The Assembler Code for this exercise would look as follows — 

LD A, 170D 

LD HL, 7000H 

LD DE, 7001H 

LD SC, 7FFH 

LD (HL), A 

LDIR 

RET 


How was this program and list of instructions put together? A process called HAND 
ASSEMBLY was used. (Hand assembly is used for short programs — longer ones are 
written using the EDASM program. ) 


To carry out hand assembly, the following pieces of information are required — 

—a numeric list of Z80 instructions, 

-an alphabetic list of Z80 instructions ard, 

—a table to convert decimal (0 - 255) numbers to hexadecimal (00H — OFFH) numbers. 


Should any user require suitable copies of the two Z80 code lists, they can send me 
$2-00 and I will forward copies by return mail. It is an interesting exercise to 
write a Basic program that will provide a tabulation of dec-hex conversion that is 
suitable for hand assembly. | 


Let's examine how this algorithm works. You may wish to refer to listing 3 to gain a 
complete understanding. The Block Fill is really best thought of as a "ripple-fill”. 
The source is always the byte preceding the destination and as the HL and DE 
registers are incremented, a destructive overwrite of the previous information in 
the block occurs. Note that the value, contained in the A register, must be loaded 
into the first memory location of the fill to initialize the process. This 
initialization is most often forgotten by beginners. Another common mistake is tc 
set the count in BC, one too high because the first byte is initialized "outside" of 
the LDIR instruction. I trust that users can follow the logic of this algorithm — if 
not, go back to listing 3 in Basic. 


The next problem in hand assembly is to find the corresponding decimal values tc 
POKE into memory as Machine Language. By using the Z80 instruction lists, mentioned 
previously, a hex equivalent of the Assembler can be derived. These are converted tc 
decimal values using a conversion table (or a calculator) and entered into DATA 
statements. It is possible to put hex values into DATA statements and use a hex 
loader routine to poke the values into the designated area of memory. 


The only remaining problem is where to load the M/L? This has been discussed in a 
previous article on FAST BASIC. For listing 4, I have chosen to simply POKE it intc 
the Free Space List. (This is a "lazy" way, but I will fix it up in the next 
listing!) The Usr Vector is set to the start of the M/L. Save the program tc 
disk/tape before running the Basic program. Assembler is totally unforgiving if any 
errors are made and you run the risk of having to re-enter the entire program. (be 
warned! ) 


Listing 4 achieves the hi-res screen fill in about 0.1 secs. This is what we were 
looking for and it is achieved with 15 bytes of M/L. I trust that this has giver 
some new insight into Assembly Language programming and taken some of the mystery 
from it. This article also provides a painless introduction to Assembly Language 


programming. 
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5. MULTIPLE HI & LO RES SCREENS. 


I have provided a bonus for those who have persevered thus far! Listing 5 1s the ‘ç 


logical culmination of the exercise we set about to achieve at the start of this 
article. It uses a slightly modified form of the routine described above. It permits 
the value selected to fill the screen to be passed, from the Basic program, to the 
USR() routine. The technique used has been described in my FAST BASIC article. The 
integer value contained in the brackets of the USR statement is placed into the 
Communication Area at address 7921/2H and can be picked up by the M/L program. 


There are three further features of this program that I have not yet discussed and 
are worthwhile to incorporate into Basic-M/L modules. 


i. When entering M/L from DATA statements, the values must be exact. Otherwise, the 
M/L routine is wrong and a computer malfunction will occur. (The same thing happens 
if the Usr Pointers are not set correctly.) As a check that the DATA statements have 
been entered correctly from a program listing, it is useful to set up a "checksum" 
facility. This simply keeps a running total of the data values as they are loaded. 
Before executing the program, the checksum is compared to a correct value and 
execution prevented if the two values do not agree. In listing 5, the variable CS% 
is used in lines 210 to 240. It is compared with the correct value in line 250 and 
if not correct passes to an error handling routine in line 1000. If the error 
message ig seen, then the DATA statements in lines 410 to 470 need to be checked. 


ii. How many program listings have you read that simply list the DATA values to be 
POKEd into memory with no explanation? Any wonder that beginners have difficulties 
in understanding! The method of setting out the M/L in "“psuedo-assembler” form is to 
be strongly recommended. 


iii. The program places the 16 bytes of M/L into a reserved area of memory created 
by lowering the Top-Of-Memory. If at any time, you feel as if the M/L routine is not 
functioning properly, then it is a simple matter to load a disassembler program and 
decode the TOM area. This ensures that it is correctly loaded, that your decimal 
values carry out the action that you think they do, and that the area is not being 
overwritten by some other processes. This 1s a very powerful form of debugging when 
developing M/L routines. 


5 LISTING 1 
5 ' LISTING 2 
t ae E 3t 28 
R oe ing E 10 '***SNATL GRAPHICS DEMO“ 
ee 20 "sen HI-RES zen 
50 VERSION 1.1 E 30 t akaa VERSION ? 3 AE E 
d'H See ' 
40 R.B.K. 22/5/86 40O '* R.B.K. 22/5/86  *** 


5O '*** EXECUTION TIME 57.6 SECS. 
100 'SET TO HI-RES. 


5O '*** EXECUTION TIME 8.3 SECS. 
100 ‘SET TO HI-RES. 


120 MODE (1) 
| 120 MODE (1) 
130 COLOR 3,0 :'RED ON GREEN 130 COLOR ,O : ‘GREEN BACKGROUND. 


200 FOR V=0 TO 63 200 FOR I%=28672 TO 30719 
210 FOR H=O TO 127 710 POKE I%.V% 


140 SOUND 10,1 140 V%=170:SOUND 10,1: ‘RED. 
220 SET (H, V) 


730 NEXT H ge 

240 NEXT V ' 260 FOR I=0 TO 2000:NEXT I 
250 SOUND 10,1 270 STOP | 

260 FOR I=0 TO 2000:NEXT I 280 END 

270 STOP G | 


280 END 


— 
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LISTING 5 


age Ne A RHA IORI AAI ES 


+ 


Eë LISTING 4° 
‘wee = VISIBLE 7-80 SS? 3 1 be ENE EH ARRAN AAA TRA RASA HART 
‘exe  DEMOOF LDIR  *** 3 '##NEAR-|TGHT-SPEED GRAPHICS DEMO*** 
‘wee ASSEMBLER TUTOR =** tiem HI-RES aen 
waw BY R.B.K 7/3/91 = 5 tee. VERSION 1.3 we 
Lon (aaa naa II 5 (ang R.B.K. 22/5/86 sg 
7g "een EXECUTION TIME 70 SECS. 7 1 te AIH HRA AAA AAR ALA AA AAAS AAA 
80 | g ‘w EXECUTION TIME <0.5 SECS. 
OD '#waDEMONSTRATION OF SCREEN FILL IN BASIC T o set DOE CODE INTO FSL ABOVE BASIC V 
HAT EMULATES EE 
100 (aset LTB DSTHCTION (E E Al, 9 FOR 1=-28687 TO -28673 
119 '##*VARIABLES USED RESEMBLE THOSE OF THE Z | 20. READ A:POKE L.A 
80 REGISTER SET. 30 NEXT I 
120 ` EECH 
130 ` 4O DATA 62,170 .'LD A,170 (#1700 BLL 
140 MODE (1) , «HI-RES SCREEN. | e 
150 COOR .0 | GREEN BACKGROUN | 41 DATA 33,0,112  :'LD HL,7000H = (#28672D ~ 
. ` TART VIDEO RAM) 
160 SAND 10,1 CERS MARS: 42 DATA 17,1,112 UD DE,7001H = (#286750 ^ 
170 ` EXT) 
180 '##ASSEMBLER SIMULATION STARTS PERE. | 43 DATA 1,255.7 LD BC.O7EFH (#20870 ` 
eu '*** INITIALIZE ALL OF THE REGISTERS USED. Ge o VIDEO RAM) 
200 A&=170 :'LD A,170 VALUE. 44 DATA 119 UD (HL),A 
210 HL%=286/2 : LD HL,7000H SOURCE Ap pr 237,176 SUDIP (BLOCK LCE 
a D COMMAND) 
220 DE%=28673 “LD DE,700tH DESTIN] 4s pata 201 RET 
ATION. E rs | 
230 BCR=204/ LD BC,O7FFH COUNT. | qg '»#INITIALIZE USRO TO ADDRESS 8FFIH OR #- 
280 | ' 986870 IN FSL. | 
Zen PUT FIRST VALUE INTO START OF VIDEO RA -0 POKE 30862, 2411 :POKE 30863, 143 
«5B 7 
300 POKE H.%,A% :*LDCHL) A 59 '**PUT UP BLUE SCREEN. 
380 | 60 MODE (1) :COLOR,O 
300 CARRY OUT DESTRUCTIVE BLOCK MOVE. JO SOND 10,1 
400 ' : 'LDIR 80 X=USR (0) 
10 POKE DEZ.PEEK(H.®) vu (06) < (HO | g0 sowo 10,1 
420 HLZ=HL%+1 S H <- Hz , 
(0 Dieter d DE <- DE+I | gg aset Ay TO VIEW SCREEN. 
A BEZ : BC <- BC-l | 100 FOR I=0 TO 2000:NEXT I 
45O IF BCZ<>0 THEN GOTO 40: ` TEST FOR END! 110 END 
460 ' ET 
470 ' 
49G swat NI CFF. 
500) SOUND 10,1 TIMING MARK. 
510 FOR 1=0 TO 2000:NEXT | | 
520 STOP ! 
600 END | 








first loop is the forty tracks, the second the sixteen sectors, 
the third the five sections that make up the sectors and finally 
the repitition of values in these sections. 

The five sections are composed as follows. The first gap 
comprises seven bytes of 80H followed by one byte of 0. The 
identification address mark, also called the IDAM is made up of 
seven bytes. FEH, E7H, 18H, C3H, the track number, the sector 
number and a checksum which is calculated from the sum of all the 
other numbers in the IDAM. If this is not what it should be 
during a LOAD or SAVE you usually get the dreaded ‘SECTOR NOT 
FOUND' error or the equally bad ‘CHECKSUM ERROR’. The second gap 
‘consists of five bytes of 80H, and one byte each of 0, C3H, 18H, 
E7H and FEH. Next is the data field, where your programs go. It 
is created by simply one hundred and twenty eight zeros. Finally 
another checksum comprising two bytes is calculated. 

Within each of the above mentioned sections of dissassembly 
listing, not a lot goes on. The timing, which is very critical, 
is calculated by the actual hardware. All the software (DOS) does 
is to load the data bit froma list and then send it to the 
drive. The actual data is recorded using Frequency Modulation 
(FM). We want to know how this affects the data. Each BIT of data 
consists of two CELLs on the disk. There is a CLOCK BIT which is 
one MICRO SECOND long. A micro second is one millionth of a 
second and is represented by uS. Following this there is an 
eleven uS gap until the actual bit of our information. If this 
bit does not exist then it is assumed to be zero. To check this 
there is a 32.2 uS gap from the start of one clock bit to the 
start of another clock bit. DUE to the simplicity of FM recording 
in the VZ drive, The rotation of the disk is slowed from the 
industry standard of 300 RPM to 80 RPM. This also allows a 
reduction in components and therfore cost. Just compare the 
number of ICs in an IBM drive to the six or seven in the VZ 
drive. 

After all that we return to the dissassembly listing to show 
that address 4CF1-4CF5 steps the head in once to lay down another 
track. When forty of these have been done the head 1s once more 
stepped out forty times (4D03-4D07) and the verification occurs. 
The track and sector (0,0) are loaded into the track / sector 
vectors anda search for the IDAM begins (4D10-4D16). If this is 
not found then we are returned to BASIC with an ‘I/O ERROR’. If 
not then the next is searched for, and so on until all are found. 
I have only ever had one disk fail during initialisation and this 
was due to a scratch on the under side of the disk. (Your data is 
recorded on the opposite of the disk to the label). This scratch 
was due to the disks previous use in an APPLE disk drive. Anyway. 
if the disk is okay then the next address after the INIT command 
was issued is loaded back into the program pointer, the power to 
the drive turned off and we jump back to BASIC. (4D40-4D44). 

Hopefully you are not all confused and now realise how much 
work is done when you press four keys. I-N-I-T-<RETURN>. 





HON THE YZ INITIALIZES A DISK 


By BEN HOBSON 





Some time ago Harry asked me to write an article on how the 
VZ initializes a disk. After a bit of hacking and careful study 
of dissasembly listings (about 13 pages) her it is. Before we 
start a few things have to be cleared up. This is not an article 
which says it writes 0's on the disk. This is an article which 
explains how the particles are arranged on the disk. While I'm at 
it, I'll also define a few terms. STEP IN refers to the head 
moving in one track towards the centre of the disk. STEP OUT is 
the exact opposite. A disk as you may know is composed of TRACKS 
and SECTORS. A track is rather like an onion ring. The VZ has 40 
of these tracks, one inside each other. The outermost track is 
called track O and the innermost is track 39. In each track there 
are 16 sectors. A sector is similar to a sector of a circle in 
mathematics. In mathematics, the sector is a wedge of the circle 
from the centre to the edge. In computing the sector is similar 
but is a section of the mathematical sector one track wide. Logic 
tells us they would be numbered 0 to 15 in a clockwise direction 
(the way the disk spins). In practise this is not so. The sectors 
are what is called INTERLEAVED. Interleaving means the next 
numerical sector is not directly next, but a number of physical 
sectors away. The reason for this is that computers are generally 
not fast enough to read the data in the sector (128 bytes in the 
VZ) and process it. By the time the data has been processed, 
hopefully the next sector is under the head. If the sectors were 
sequential the disk would have to rotate once to get the next 
sector. In the VZ a two sector interleave is used. This means 
between each numerical sector there is two physical sectors. The 
order is 0, 11, 6, 1, 12, 7. 2, 13, 8, 3, 14, 9, 4, 15, 10, 5. In 
the VZ's case this is a little too much. That is why people like 
Dave Mitchell have written patches for DOS to create a one sector 
interleave. This considerably speeds things up. 

Now for the technical stuff. If you really want to know what 
is going on a dissassembly listing from 4B08 to 4D44 hex will 
come in handy. (Two pages) 7 

To start with a DI command is issued (4B08). This dissables 
the interrupts to ensure the DOS is not disturbed by some trivial 
thing. | 

Then the power is turned on to the drive (4B09) via a call to 
the power on routine. A slight delay is called for to allow the 
motor to get up to speed (4B0C-4B13). Next the disk is checked to 
gee if a write protect label is in place (4B14-4B19). If so the 
DOS jumps back to BASIC with the appropriate message. 

Next track 0O sector 0 is loaded into the track / sector 
vectors. The head is then moved out 40 tracks. This achieves two 
purposes. To make a lot of noise and to ensure the head is over 
track 0. A small delay is called once more and the action begins. 

There are now seven fairly similar looking routines. They 
are; 4B94-4BBA, 4BBB-4BE1, 4BE2-4C08, 4C09-4C2F, 4C30-4C56, 
4C57-4C7D and 4C7E-4CA4. These routines are responsible each for 
a different value. Each sector consists of five parts. It starts 
with a gap, then an identification mark, another gap, the actual 
data field, and finally a checksum. The five numbers needed in a 
sector are; 0, 80H, PER. E7H, 18H, C3H and a checksum. The actual 
procedure of laying down the sectors is a series of loops. The 
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GAMES COLUMN 


Paul has'nt been able to make it this issue again. 


Bear with Paul for now. He has some important exams coming up. and 


no doubt will be on tap for next issue. [Ed]. l 
I have a correction to make. Last month I credited Mathew McLean 


with Peter Watson's score of 1918 for Super Snake. I have corrected 
it this issue. 


The HIGH SCORES 


e e a = a itir ma 
V + 


Arae ae ten: 


GAME SCORE LEVEL HOLDER 
DAWN PATROL 65500 Martin Wedgwood 
CRASH 581 Peter Watson 
DIG OUT 52500 Kenley McLean 
HAMBURGER SAM 46400 Peter Watson 
LADDER CHALLENGE 23970 Peter Watson 
KAMIKAZE 113410 Peter Watson. 
TEN PIN BOWLS 206 Bernice O'Mahoney 
VZ INVADERS 30160 Peter Watson 
GALAXON 328,460 Mathew McLean 
PENGUIN 2320 Peter Watson 
LUNAR LANDER , 17400 Peter Watson 
SUPER SNAKE 1918 Peter Watson 
MAZE OF ARGON ; 78306 Peter Watson 
ASTEROIDS 110000 Peter McLean 
CIRCUS 2690 Kenley McLean 
PANIK 11090 Martin Wedgwood 
HOPPY 25550 Matthew McLean 
GHOST HUNTER 23400 Chris McLean 
STAR BLASTER 480 units left Matthew McLean 
KNIGHTS & DRAGONS : 5300 Easy Peter Watson 
KNIGHTS & DRAGONS 1200 Expert Peter Watson 
SPACE RAM i 805 Peter Watson 
MISSILE ATTACK ` 21460 Peter Watson 
BUST OUT 1970 Peter Watson 
PLANET PATROL 471 Peter Watson 
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H.V. V-Z- U.O 


USEF GEOUF S 


DISKMAG 
F.0.Box 600. 


P.O.Box 161 
JESMOND NSW. 2299. 


CENT. VIC-COMP.Club 
>24 Breen St. 
BENDIGO VIC 3550 


Taree NSW. 2420. 


BRISBANE VZUG 
63 Tingalpa St. 


WYNUM West. Q’ ld. 4178 


Graeme Bywater 
P.O.Box 388 


MORLEY 


W.A. 6062 
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ADVENTURE GAME WRITING - IMPROVING THE VOCABULARY OF THE GAME , 


Many commercial adventurea on larger computera have vocabularies 
of several hundred worda and enable the player to enter commanda using 
engliah-type aentencea. Some alao allowed the player to enter compound 
commanda - commanda where more than one action can be carried out - 
auch aa GET THE WOODEN STAKE, KILL THE VAMPIRE, THEN ENTER. 

There are quite a few problema with the laat of theae, but it is 
posaible to make the computer underatand sentences of a aort. The 
improved vocabulary ia due to more plot, and therefore more words to 
carry out extra actions, extra words used to hold the sentences 
together, auch aa "IN" or “THE”, and extra words that mean the same 
thing, such aa “LOOK” and "EXAMINE". Extra words make it more likely 
that the player will choose the right word firat time, but may take up 
a little extra memory. 

Some playera prefer to be able to communicate in sentences because 
it makea them feel more a part of the game as they are “talking™ to 
the computer. However for othera, the lesa typing, the better, 30 for 
them the old verb-noun parser La preferable. 

In MERKFRUIT LODGE some aort of compromiae ia achieved. It allows 
playera to enter sentences if they really feel like it, but alsac 
allowa the two word parser to be used. 

The paraer aasaumea the firat word of the command ia a verb, 80 
thia has been placed in V8. The reat of the command ia left in Ts. 
(Note that aa theae linea are from MERKFRUIT, they will not fit into 
the line numbera of the demo program.) 





35Q IFLEFTS(TS,3)="AT “THENTS=MID&(TS,4) 
354 IFLEFTS(TS,3)="IN "“THENTS=MIDS(TS, 4) 
356 IFLEFTS(TS,4)="THE “THENTS=MIDS(TS,5) 


Theae three linea remove the AT or the IN from commands such as LOOK 
AT THE ROCK or LOOK IN THE CUPBOARD. Next the word "THE" is removed 
from these commanda and alao commanda auch asa GET THE AXE. Of corse, 
LE there are no ATa, INa or THEs, nothing is removed. Line 357 removes 
a full atop from the end of the command if there ia one there. 

357 IFRIGHTS(TS,1)="."THEN TS=LEFTS(TS,LEN(TS)-1) 

The following lines find out the last word of the command. This is for 
dealing with aituationa where the following happena: 

Player: GIVE AXE 

Computer: GIVE THE AXE TO WHOM? 

Player: FRED | 

The player could inatead type GIVE THE AXE TO FRED all in one command 
Cor just GIVE AXE FRED if (a)he felt like it). 

358 FORI=1TOLEN(TS) :IFLEFTS( RIGHTS(TS,1),1)=" “THENK=I:I=LEN(TS) 

359 NEXT:IFK>@THENLS=RIGHTS (TS,K-1) 2: K=0 


Now the laat word ia left in Lg, and the computer will ignore 
everything but the firat remaining word in TS, which it assumes to be 
the noun. If there ia only one word in TS, LS ia left blank. 

The contenta of L# can then be used from within a verb routine. If 
the player haa not typed the aecond noun the routine should atill ask 
GIVE THE (thing) TO WHOM? aa before. 


1640 IFLS<>""THENTS=L3:GOTO1647 
1645 PRINT"GIVE THE ";TS;:INPUT" TO WHOM";TS 
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1647 U=1:GOSUB XXX:U=0 
Replace XXX with the line number of the line where the noun number ia 
determined. The noun number of thia second object will be placed in B. 


‘Start of noun sorting routine 
FORI=1TO NO: IFMIDS¢(YS3,1*3-2,3) =LEFTS(TS,3) THENB=I:I=NO 
NEXT: ITFU=1THENRETURN 


Thia ia the equivalent of linea 320-330 of the demo program. Note the 
use of the “IFU=1THENRETURN" which doea not actually appear in the 
progran. 

The major problem with using compound commanda ia knowing when the 
entire input must be rejected. Obviously if for some reason the player 
can’t GET THE WOODEN STAKE, it isa unfair to expect him to KILL THE 
VAMPIRE with hia bare handa. However you might like to deaign a 
routine ao that a player can go N,N,E,E,S,W all in one move, or GET 
THE THICKSHAKE AND THE HAMBURGER. Already aome VZ adventures feature 
the command GET ALL, which enablea the player to pick up every 
visible, gettable object in the room at once. 


GRAPHICS 


Very few adventurea for the VZ contain any graphics at all. 
ADVENTURE ISLAND ia the only one I have come across that isa graphics 
based, although several of the VZ Down Under adventures, contained 
title acreena designed using GRAFSTAR, a utility which was formerly 
available from VZ Down Under, but I am unsure about ita current 
availability. 

Becauee each hi-res acreen takes up 2K of memory, it ia not 
feasible to store whole acreena unleaa you atore them on disk and load 
each one into memory aa needed, or load them using 16K blocks into the 
64K RAM expansion pack. 

To achieve the firat method, you will need to write a program to 
draw your hi-res acreen and at the end of it place a 
BSAVE"filename",7000,77FF command. To reatore your screen when needed 
BLOAD your file naing the appropriate filename. Of course you will 
need to change the acreen to MODE(1) before doing this and use a 
different filename for each acreen. See the article in VZDU#6 for more 
detaila. For the second method, deaign each acreen and load it into a 
memory block using Bob Kitch’s Screen mode mover(VZDU#19- alao 
appeared in LE’VZ). Once each 16K block ia full aave it to diak using 
a Similar command to that above (Note the HEX numbers) or to tape by 
changing the atart and end of basic pointers (aee VZDU#7 or #28). To 
load the acreens in your program, load them into memory and then use 
the acreen mode mover to put them on the acreen. You will need to 
change the line numbers of this routine because they will probably 
clash with those of your adventure. Also note the use of the CLEAR 
command in line 3050. In thia form it will not work aa a subroutine, 
because amongst other thinga, the CLEAR command tends to clobber 
Basic’s atack, with the result that the computer forgets where it has 
to RETURN to at the end of the subroutine. To fix thia, replace line 
3050 with a RETURN command, and when you wiah to call the subroutine 
use GOSUB3000:CLEAR3@9@: GOSUB3060e 
Thia method takea up more effort and memory, but ia the only 
alternative for 64K expansion ownera who don’t own diaka, and saves 
diak and drive wear and tear for those who do. I haven’t gone into 
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disk— and—drive—_weer—and—teer fer these whe der ft _haven-t-gene into 
full detail because I do not own either a diak drivevor a 64K 
expanaion so am not aure whether I have outlined each method 
correctly. Thia diacuasion ia more aimed at giving people ideaa on 
what they could do. 

Another poaaible method ia to draw the aame general room shape for 
every room, adding doora where required. From thia it would be a 
matter of adding pictures of gettable objecta and some fixed objects 
in the rooma where they appear (eg. bed, table, window, rope, shovel, 
ticking parcel, etc.). Hardly 256 colour VGA atandard graphica but it 
ia a atart. You may like to use mixed text/hi-res graphica using the 
routine in the April/May edition of VZ USER. Thia routine enabled four 
linea of text and 127 by 48 pixel graphica, and ia aimilar to one used 
by Larry Taylor to create Eacape River. Because of the length of the 
routine I cannot reproduce it here, and because VZ USER ia no longer 
produced, I don’t know where you can obtain a copy if you haven’t got 
one. If you do have a copy, remember that the Y part of the graphics 
rangea from 4 to 51 (not @ to 47 aa you might expect), that you cannot 
use INPUT atatementa - to get the player’a command you must use the 
INKEYS atatement, and to save your effort regularly - if you make an 
error or press BREAK while the program is in aplit screen mode, you 
will loge control of the ayatem and have to reaet the computer. If you 
uae thia feature you will alao have to keep your deacriptiona down to 
a minimum ao everthing fita into four linea. The program below ia an 
example of how you could draw a room. Y values are kept in the range 
of 4 to 531 in case you decide to use the aplit acreen; if you don’t 
uae it you can change the program to make the room a bit bigger. The 
program makes up a random movement code which ia then used to draw 
doors in these positions. In the program the far wall is said to be 
north. Linea 240 and 250 draw a barred window in the north wall. 


9@ FORI=1T04:DS=DS+MIDS(STR&( RND(2)-1),2,1) :NEXT 
98 COLOR1+RND(3) 

99 MODE(1) 

10@ FORX=@TO97:SET(X,51) :NEXT 

11@ FORY=19T051:SET(@,Y)!: SET(97,Y):NEXT 

12@ FORX=30T097:SET(X, 36) :NEXT 

125 FORY=4T036:SET(127,Y)!: SET(30,y) :NEXT , 
13@ FORI=1T030:SET(30-1,36+(I/2)): SET(127-1,36+(I/2)) 
140 SET(30-1,4+¢I/2)):SET (127-1,4+(I/2)) !NEXT 

15@ FORX=30T0127:SET(X,4) :NEXT 

155 IFLEFTS(DS,1)="1"THEN175 

16@ FORY=19T036:SET(68,Y):SET (88,Y) :NEXT 

17@ FORX=68TO088:SET(x,19) :NEXT 

175 IFMIDS(Da,3,1)="1"THEN195 

18@ FORI=10TO2@:SET (3@-1,19+(I/2)) :NEXT 

19@ FORY=24T041:SET(20,Y):SET (10,Y+*5) :NEXT 

195 IFRIGHTS(DS,1)="1"THEN215 

200 FORI=10TO20:SET- (127-1,19+(I/2)) INEXT 

210 FORY=24T041:SET(117,Y)iSET (107,Y+5) !NEXT 

215 IFMIDS(Da,2,1)="1"THEN240 

22@ FORX=38T058:SET(X,49): RESET(X,51) :NEXT 

230 FORY=49T051:SET(38,Y):SET (58,Y) :NEXT 

240 FORX=40TOS6:SET(X,9) SET (X,19) :NEXT:FORX=40TOS6STEP4 
25@ FORY=9TO19:SET(X,Y) :NEXT!NEXT 

1208 GOTO100e 
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A ek and—drive—weer—and tear _for_these ube dereen" "Kane into 
full detail because I do not own either a disk drive or a 64K 
expanaion 80 am not aure whether I have outlined each method 
correctly. Thia diacusaion ia more aimed at giving people ideaa on 
what they could do. 

Another poasible method ia to draw the aame general room ahape for 
every room, adding doora where required. From thia it would be a 
matter of adding pictures of gettable objecta and aome fixed objects 
in the rooma where they appear (eg. bed, table, window, rope, shovel, 
ticking parcel, etc.). Hardly 256 colour VGA atandard graphica but it 
ia a asatart. You may like to use mixed text/hi-res graphics using the 
routine in the April/May edition of VZ USER. Thia routine enabled four 
linea of text and 127 by 48 pixel graphics, and ia aimilar to one used 
by Larry Taylor to create Eacape River. Because of the length of the 
routine I cannot reproduce it here, and because VZ USER ia no longer 
produced, I don’t know where you can obtain a copy if you haven’t got 
one. If you do have a copy, remember that the Y part of the graphics 
rangea from 4 to 51 (not @ to 47 as you might expect), that you cannot 
uae INPUT atatementa - to get the player’s command you must use the 
INKEYS atatement, and to save your effort regularly - if you make an 
error or preaa BREAK while the program ia in aplit acreen mode, you 
will lose control of the ayatem and have to reaet the computer. If you 
uae thia feature you will alao have to keep your deacriptiona down to 
a minimum ao everthing fita into four linea. The program below ia an 
example of how you could draw a room. Y values are kept in the range 
of 4 to 541 in case you decide to uae the split screen; i£ you don’t 
uae it you can change the program to make the room a bit bigger. The 
program makea up a random movement code which ia then uaed to draw 
doora in these positiona. In the program the far wall is said to be 
north. Linea 248 and 250 draw a barred window in the north wall. 





99 FORI=1T04:DS=DS+MIDS(STRS¢( RND(2)-1),2,1) :NEXT 

98 COLOR1+RND(3) 

99 MODE(1) 

100 FORX=0TOS7:SET(X,5S1) : NEXT 

119 FORY=19T051:SET(@,Y): SET(97,Y) :NEXT 

120 FORX=30T097:SET(X, 36) :NEXT 

125 FORY=4T036:SET(127,Y): SET(30,y) : NEXT 

430 FORT=1T030:SET(30-1,36+¢(I/2)): SET(127-I,36+¢1/2)) 
14@ SET(30-1,4+¢I/2)):SET (127-1,4+(1I/2)): NEXT 

150 FORX=30T0127:SET(X,4) :NEXT 

155 IFLEFTS(D9,1)="1"THEN175 

160 FORY=19T036:SET(68,Y):SET (88,Y):NEXT 

170 FORX=68T088:SET(x,19) :NEXT 

175 IFMIDS3(D8,3,1)="1"THEN195S 

18@ FORI=10TOZ2@:SET (30-1,19r¢(I/2)):NEXT 

19@ FORY=24T041:SET(20,Y):SET (10,Y+5) :NEXT 

195 IFRIGHTS(DS,1)="1"THEN215 

200 FORI=10TO20:SET- (127-1,19+¢(I/2)) NEXT 

210 FORY=24T041:SET(117,Y):SET (107,Y+*S) :NEXT 

215 IFMIDS(D8,2,1)="1"THEN240 | 

220 FORX=38T0O58:SET(X,49): RESET(X,51):NEXT 

230 FORY=49T051:SET(38,Y):SET (58,Y):NEXT 
240 FORX=40TO56:SET(X,9):SET (X,19) :NEXT:FORX=40TOS6STEP4 
25@ FORY=9TO19:SET(X,Y) :NEXT: NEXT 

180@ GOTO190e 
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HIDDEN EXITS 





Programming 
BO the Player 

JO eaat again 

itaelf, 

Include the Find Lin We used temporarily laat 
iaaue at the th the Other Machine Code 
routines, 
eg 


18 DATAD T 299T031304:READA - POKEI,A:NEXT 
22 "70287, 91,33, 121,208, 2! "Dinge, 99, 


data Statement that Containa your MOvement Code. For example, 1£ your 
DOvenent Code waa in line 5202, and the line after that was 5210, you 
) 


Depending on which exit you wiah to Change, YOU muat Subtract a 
Certain Value from X. For eaat Subtract three: for west, four: for 
aix. 


Co Create a new exit, POKE X,48, If you Wlah to Block 
49 


Prograga later ON, veu will finda Your new exit viii have magically 
disappeared After the Progresa haa been reloaded, the Program Could 
Check any Changea that need to be made, and make them again. 

Finally if you teat drive Your Program, don’t forget to Change the 
line back to ita original MOvement Code before YOU save the Program. 
It WOuld alao be & good idea to include a little routine to Change 
everything back i¢ the player QUITa or diea. ' 


RANDOM MOVING ITEMS 











cy may be some kind of animal, or a small object that can be blown 
round in the breeze. They add a little intereat to the gamé because 
BF the player never knowa where they are going to meet. 

P" In the demo program there ia a dog that movea around between three 
. different rooma. Thia ia the code that allowa it to do so: 


480 IFF (30) =10RF (22) =26THENSO@ 

If the dog haa decided to follow you, or run away, this section ia 
ignored and skipped. 

485 U=RND(3) :IFF(22)=SANDU=1THEN F(22)=4:GOTOS0@ 

490 IFF (22) =S9ANDU=3THENF(22)=4: GOTOS00 

495 IFF (22) =4ANDU=3THENF(22)=5: GOTOS@2 

497 IFF (22) =4ANDU=1THENF (22)=9 

F(22) ig a flag which containa the location of the dog. It may be that 
the player can pick up a random moving item (eg a piece of paper 
blowing around in the breeze). In thia case you would use an element 
of the C array to atore the item’a location. 

In moat cases the code ia simpler than thia, if you decide to have 
your item move along one particular row or column of your map. In this 
case it ia juat a matter of calculating the new position. We will 
asaume the item ia C(18) and ia in an 8X8 map and can move north and 
aouth between rooma 16 and 56 


IFC¢(18) =RORC (18) =@0RC(18)=65 THENRETURN 
U=RND(3)-2:IF(C(€18) =16ANDU=-1) OR(C(18) =S6ANDU=1) THENU=-U 
C618) =C(18)+¢U#8) 

RETURN 


Obviously if you want your object to move east/west, you should not 
multiply U by 8. Your object ahould not be able to walk through walls. 
Experienced programmera might like to make up a routine to enable the 
item to move anywhere it likes, provided it looks at the novement 
codes to aee if the move ia legal. 


Thia virtually concludea the series. There are one or two more 
articlea to come on tokeniaed room deacriptions and the use of program 
modulea and these will appear later on. Following is a brief aummary 
of the atepa involved in writing your own adventure, in the order you 
might wiah to carry them out. The iaaue of VZDU to refer to ia also 

noted. 


Think of something to write about! (#27) 

Think of a character, a plot and some puzzlea (#27) 

Make a liat of nouna and verba for the computer to underatand (#27) 
Draw a map, and compile your movement codea (#27) 

Make up aome room deacriptional#27) 

Type in the machine code, initialisation and data atatementa (#29) 
Type in the acreen diaplay and command parser (#30) 

Deaign your verb aubroutinea, type them in and Inatall the ON GOSUB 
linea (#31) 

Add aounda (#29) and other extraa 

Progreaa tape aave routinea (#28) DO LAST! 


Good luck writing your adventure program. I hope to see a few efforts 
published in VZDU magazine or the public domain tape soon! 
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They said it would’nt happen, but it has! THE GAMES 
COLUMN IS BACK! 


Actually this month it is really Peter Watson's 
column. Since he has been the only contributer of late, the 
above is justifiable. Still as I’ve said before, if just one 
person contributes every coupi of months, that is more than 
enough reason to write this column. (Thanks Peter.(Ed.)) Well 
with that out of the way let me hand the column over to Feter’s 
hints and comments. 


Note there are no adventure game reviews this month as 
I have run out of adventures to review. If anyone has built a 
masterpiece thanks to David Wood’s tutorials, I would be more 
than happy to review it. 


CRASH. Use the speed button as little as possible, as 
you run out of fuel much more quickly. 


ASTEROIDS. Ignore a "chunk" of asteroid and wait for 
the UFO to appear. It is worth 1000 points. Once you have 
destroyed it, wait for another UFO etc. (Patience required 
here). 


LUNAR LANDING. Ignore the 100 and 300 point landing 
pads. The S00 point pads are as easy to land on. (I can crash 
anywhere. (CEO, Ai 


As well as the abovehints, Peter has Provided us with 
thefollowing mini reviews of a couple of arcade/action games. 
Thankyou Peter. 


KAMIKAZE. I suppose a few club members will skin me 
for saying this....but a game of kamikaze lasts too long. After 
the first few frames, the level of difficulty remains the same. 
My high score of 113410 took ihr 17min., after which I had eye 
strain!!! (Its an endurance test Peter, not a game of skill 
Ed.)). I think the game would be better, if say the bombs were 
faster or there were more of them per frame. I also note that as 
the Kamikazes built up on the screen, (there can be up to 50 of 
them), the action slows up noticeably. {© Could make the test the 
time to reach 10,000 or so. Ed.} 


Asteroids. The game would be less drawn out if there 
were no extra lives given every 10000. Also it is very easy, 
when playing with Joysticks, to accidentially hit Hyperspace and 
reappearin a very dangerous spot. Thanks again to Feter for his 
contribution to this column, especially since this column writer 
bacame bogged down with school exams. Once again if you have a 
review, hints orquestions or high scores etc., please send them 
into my address below. SEND THEM IN NOW AND KEEP V.Z GAMING 
THRIVING. 


See you next editio 


Faul Frantz. 25 Crocker St. KIRWAN. Q@*° ld. 4817. 
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